home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Utilities / Programming / MT2Trivial 2.1.3 / MT2Trivial 2.1.3 ƒ / Read.Me < prev   
Encoding:
Text File  |  1997-07-24  |  13.3 KB  |  349 lines  |  [ttro/ttxt]
  1. MT2Trivial, version 2.1.3
  2. ©  Copyright by Michael Trofimov, 1996, 1997.
  3. email : mtrofimov@glas.apc.org
  4. URL: http://www.glasnet.ru/~mtrofimov/
  5.  
  6. ______________________________________________________
  7. File Read.Me
  8. ______________________________________________________
  9.  
  10. This Drag&Drop utility generates C/Pascal source from resource
  11. file.
  12.  
  13. NOTE : MT2Trivial is shareware, see REGISTERING for more info.
  14.  
  15. CONTENTS .
  16.  
  17.      1.     FILES/FOLDERS LIST.
  18.      2.     ABOUT MT2Trivial.
  19.      3.     BALLOON HELP.
  20.      4.     ABOUT CUSTOMIZATION.
  21.      5.     AN EXAMPLE.
  22.      6.     VERSION HISTORY.
  23.      7.        ACKNOWLEDGMENTS
  24.      8.     BUG REPORTS, COMMENTS ETC.
  25.      9.     COPYRIGHT
  26.     10.        REGISTERING
  27.     11.     OTHER MT2 SOFTWARE
  28.     12.     ABOUT THE AUTHOR.
  29.  
  30.  
  31. 1. FILES/FOLDERS LIST.
  32.  
  33. "MT2Trivial 2.1.2 ƒ" folder contains three folders ("MT2Trivial Templates ƒ ", 
  34. "MT2Trivial Documentation ƒ " and "Example ƒ ") and the following files:
  35.  
  36.         Read.Me                   -- this file;
  37.         MT2Trivial              -- the application;
  38.  
  39. NOTE :  "MT2Trivial Documentation ƒ " folder is included into registered
  40.             version only. This folder contains MT2Trivial documentation, bug 
  41.             info etc. In limited-version this folder is absent. 
  42.         
  43. "MT2Trivial Templates ƒ" folder contains two folders ("MainLoop THINK Pascal ƒ " 
  44. and "MainLoop CodeWarrior C ƒ ") and the following files:
  45.        
  46.         TemplateStrs.c.Trivial
  47.         TemplateStrs.p.Trivial  -- Template strings file;
  48.  
  49.         Head.c.Trivial                        
  50.         Uses.p.Trivial                -- pattern file to generate "uses" list;
  51.         
  52.         User.c.Trivial
  53.         User.p.Trivial                  -- pattern file to generate user's code;
  54.  
  55.         MakeMenu.c.Trivial                        
  56.         MakeMenu.p.Trivial        -- pattern file to generate menu bar support 
  57.                                                  procedures (1);
  58.         MenuComm.c.Trivial                        
  59.         MenuComm.p.Trivial      -- pattern file to generate menu bar support 
  60.                                                  procedures (2);
  61.         NewWindow.c.Trivial        
  62.         NewWindow.p.Trivial     -- pattern file to generate DoNewWindow
  63.                                                                         procedure;
  64.         
  65.         MainLoop.c.Trivial
  66.         MainLoop.p.Trivial         -- pattern file to generate events related 
  67.                                                   procedures;
  68.          
  69.     "MainLoop THINK Pascal ƒ" folder contains :
  70.     
  71.               MainLoop.p.Trivial   -- pattern file to generate events related      
  72.                                                   procedures according to THINK Pascal terms;
  73.                                    
  74.     "MainLoop CodeWarrior C ƒ"    folder contains :
  75.     
  76.         MainLoop.c.Trivial         -- pattern file to generate events related      
  77.                                                procedures according to CodeWarrior C terms;
  78.                                                                                                                         
  79.     "Example ƒ" folder contains :
  80.     
  81.         test.rsrc                          -- an example resource file;
  82.         
  83.         test.p                               -- Pascal source generated by MT2Trivial from 
  84.                                                   "test.rsrc " file;
  85.                                       
  86.         test.make                    -- MPW make file for compiling and linking 
  87.                                                   "test.p " and "test.rsrc " under MPW;
  88.                                      
  89.         test                                -- the application (produced from the sources 
  90.                                                  "test.p " and "test.rsrc "; the similar
  91.                                                  application may be produced from "test.c "...).
  92.                   
  93.  
  94. 2. ABOUT MT2Trivial.
  95.                                                 
  96. Drag a resource file onto MT2Trivial icon. MT2Trivial asks you about settings 
  97. (via two dialogs), reads resources from selected file and writes C or Pascal 
  98. program to output file, where
  99.   
  100.   -- resources IDs will be listed in constant definition list;
  101.   
  102.   -- templates of procedures/functions to support some types
  103.      (DLOG,MENU,WIND, etc.) of the resources will be introduced;
  104.           
  105.   -- some other templates for standard procedures/functions such 
  106.      as Mac managers initialization and event loop will be represented;
  107.      
  108.   -- other templates to generate user's custom code may be used;
  109.      
  110.  etc.
  111.  
  112.     A user can select resources for source code generation, choose
  113. language (Pascal or C), output file name etc. via two dialog windows.
  114. The first window is Preferences window. It will open after 
  115. dropping input file icon onto MT2Trivial icon. When user presses OK
  116. button, setup parameters from this dialog will be saved in
  117. MT2Trivial preferences file in Preferences folder of System folder,
  118. and then the second dialog window will open. There are listed all
  119. resources from input file in this dialog, and user is able to select
  120. necessary resources (by type or by ID) for generation. In contrast
  121. with the first dialog the second dialog settings will not be saved
  122. anywhere.
  123.  
  124.     To generate a name (identifier), MT2Trivial gets name of this
  125. resource from input and to provide readable code, each resource
  126. (except DITL resources) should be named before generation. You can
  127. do it via your favorite resource editor (for example, via ResEdit),
  128. before MT2Trivial launching, as well as in the second dialog of 
  129. MT2Trivial. 
  130.  
  131. NOTE : MT2Trivial changes resource names only for generated target 
  132.              file, but does not change resource name, or something else 
  133.              in input (source) file. 
  134.  
  135.     MT2Trivial ignores characters, which are not appropriated for
  136. identifier's syntax and adds letter prefix to identifier if
  137. resource name begins from digit, and so on. Also a user can easy rename 
  138. program identifiers later  through Canon MPW tool. For this possibility
  139. MT2Trivial generates Canon dictionary file (".Dict " file name extension). 
  140.  
  141.     To generate procedure templates MT2Trivial uses pattern files :
  142.  
  143.         MainLoop.x.Trivial
  144.         MakeMenu.x.Trivial
  145.         MenuComm.x.Trivial
  146.                             (where x  is "c " or "p "), and
  147.                              
  148.         Uses.p.Trivial  or Head.c.Trivial
  149.  
  150. which templates look like well-known "Inside Macintosh" examples . 
  151. You can modify these files to get necessary result of generation. Also, 
  152. there are another goodies to simplify  your programming work. For 
  153. example, MT2Trivial copies Uses template with alphabetical list of 
  154. standard units, and you can simply cut&paste the necessary of them. 
  155. You can include names of your own units to "Head.c.Trivial" (for C) 
  156. or to "Uses.p.Trivial" (for Pascal) files. Also, there are "User.c.Trivial" 
  157. and "User.p.Trivial" empty files, which you can use to define you own 
  158. patterns (see, CUSTOMIZATION section for more info).
  159.  
  160. NOTE 1: There are Toolbox initializations in "MainLoop.p.Trivial" file, 
  161.                that is not necessary for THINK Pascal. So, for THINK Pascal 
  162.                environment replace the file with "MainLoop.p.Trivial" file 
  163.                from  "MainLoop THINK Pascal ƒ" folder!      
  164.       
  165. NOTE2:  For CodeWarrior C environment replace the file "MainLoop.c.Trivial" 
  166.                  file from "MainLoop CodeWarrior C ƒ" folder!
  167.  
  168. There are special condition compilation directives to control
  169. generation from templates (see, CUSTOMIZATION section for more info).  
  170.  
  171. MT2Trivial inserts placeholders (commented by %%-markers) where
  172. programmer should insert or modify source code. However, in some
  173. cases the generated program pattern may  be compiled, linked and
  174. executed successfully (for example, run the test application, which
  175. was built by "test.make" file, from "test.p" gotten from MT2Trivial's
  176. output as is.) Of course, the  test does not make any useful works
  177. -- it's pattern only, but it's valuable pattern -- it runs without
  178. run-time errors! The similar error free program you will receive
  179. from "test.c" file. 
  180.         
  181. By default MT2Trivial generates the most complete source, but
  182. for some tasks, for example, when your program has been already
  183. written and you need to insert there additional constant list, the
  184. full text generation may be too redundant -- too large parts of the
  185. text you would erase by hand. In similar cases you can suppress
  186. generation of the parts through setting in Preferences dialog. 
  187.  
  188. NOTE : The number of resources may be used for generation  is very 
  189.            restricted for limited version of MT2Trivial (Not more 36 
  190.            resources in resource file is possible). The registered
  191.            version has not this limitation.
  192.  
  193.  
  194. 3.BALLOON HELP.
  195.  
  196.     Use standard Balloon Help to get detailed info. 
  197.  
  198.  
  199.  
  200. 4.ABOUT CUSTOMIZATION.
  201.  
  202.     To customize MT2Trivial to his/her purposes, a user can modify
  203. template files and some resources of MT2Trivial application.
  204. However other items could not be changed. Read about customization
  205. before you try to modify something yourself. 
  206.  
  207.     Possible customization described in details in "Customization.doc"
  208. file "MT2Trivial Documentation ƒ " folder. This folder included into 
  209. package of registered version of MT2Trivial.
  210.  
  211.  
  212.  
  213. 5. AN EXAMPLE.
  214.  
  215. 1) create "test.rsrc" file by any resource editor 
  216.     (ResEdit, for instance) or use "test.rsrc" file 
  217.     from "Example ƒ" folder.
  218.  
  219. 2) drag "test.rsrc" icon by mouse and drop the icon onto 
  220.    MT2Trivial icon: you will be prompted about generation 
  221.    parameters, change them and press "OK" button, then 
  222.    select resources for generation in the next dialog,
  223.    and press "Done" button -- generation progress box 
  224.    will appear. In the result "test.p" or "test.c" file
  225.    (according to selected language) will be written 
  226.    by MT2Trivial.
  227.    
  228.     Now you are able to modify and compile "test.p" (or "test.c")
  229. file for your needs.
  230.  
  231. 6.VERSION HISTORY.
  232.  
  233. July, 1997:                       MT2Trivial, version 2.1.3:
  234.                                            a few bugs are fixed; documentation is changed;
  235.  
  236. February, 1997:          MT2Trivial, version 2.1.2:
  237.                                            dialogs are improved; 
  238.  
  239. December, 1996:         MT2Trivial, version 2.1.1:
  240.                                            user interface is improved; documentation is changed;
  241.  
  242. October, 1996:              MT2Trivial, version 2.0d2:
  243.                                            stack overflow bug for large number of source resources 
  244.                                            is fixed; new application icons family is implemented;
  245.  
  246. July/August, 1996:     MT2Trivial, version 2.0d1:
  247.                                            reading resources as is: conversion to resource
  248.                                            description file is unnecessary, now; preferences
  249.                                            support; GUI of MT2Trivial is revised. Balloon help
  250.                                            is added. Documentation is revised. 
  251.  
  252. May/June, 1996:          MT2Trivial, version 1.0b2:
  253.                                    GUI support procedures of current version of 
  254.                                    MT2Trivial had been generated by Trivial MPW Tool,
  255.                                    after that generator's procedures from Trivial 
  256.                                    were improved  and introduced to MT2Trivial utility.
  257.  
  258. October,1995:             Trivial, version 1.0b1 MPW tool:
  259.                                    This MPW Tool was included in MT2Toolkit for 
  260.                                    MPW Pascal programmers.
  261.  
  262.  
  263. 7.ACKNOWLEDGMENTS
  264.  
  265. Many thanks to Lev Possajennikov <leo@adi.com.au> for very productive
  266. discussion of Trivial & MT2Trivial. 
  267.  
  268.  
  269. 8. BUG REPORTS, COMMENTS ETC.
  270.  
  271. Please, send it via email to mtrofimov@glas.apc.org
  272.  
  273.  
  274. 9. COPYRIGHT
  275.  
  276. Copyright by Michael Trofimov, 1996,1997.
  277.  
  278. To publish the program, for example, to insert it into CD-ROM, please 
  279. ask the author about permission.
  280.  
  281. All files listed in "FILES/FOLDERS LIST" should be copied as is.
  282.  
  283.  
  284. 10.REGISTERING
  285.  
  286. There are a few important differences between MT2Trivial-limited
  287. and registered version. 
  288.  
  289. 1) MT2Trivial-limited can not proceeds more than 36 resources,
  290.    registered version can.
  291.    
  292. 2) Documentation folder is inserted into registered version only.
  293.  
  294. Also:
  295.  
  296.     --     Registered user periodically receives FAQ and 
  297.              Found Bugs Reports via email.
  298.        
  299.     --    The next update of MT2Trivial will be free for 
  300.             registered user!
  301.  
  302. Please, send email to: <mtrofimov@glas.apc.org>.
  303. You will be informed where to transmit shareware fee
  304. (according to your geographical location).
  305.  
  306. After your shareware fee will be received you will get 
  307. registered version of MT2Trivial package via email in
  308. ".sit.hqx" format: use any BinHex4 and StuffIt utility
  309. to decode and decompress the archive.
  310.  
  311. Shareware fee is $19US (+your expenses to transmit the fee).
  312.  
  313. In some cases reasonable discount may be possible. (Be sure to
  314. ask about it via email -- please, note your reason for that!)  
  315.                                 
  316.                                 
  317. 11. OTHER MT2 SOFTWARE.
  318.  
  319.         
  320.  * Color Music System Prometheus
  321.  * MT2hyperDisk 
  322.  * and more... 
  323.  
  324. Please, see URL: http://www.glasnet.ru/~mtrofimov/
  325.  
  326.  
  327. 12. ABOUT THE AUTHOR.
  328.  
  329. Michael Trofimov is a computer scientist, chemist and programmer. 
  330. He works in Lab of Computer Chemistry, N.D.Zelinsky Institute of 
  331. Organic Chemistry of Academy of Sci. of Russia. 
  332. Also he makes independent researches and commercial programs
  333. development.
  334.  
  335. The MT2Trivial was planned as accumulation of author's experience 
  336. of methods to solve tasks of practical programming. Author uses it
  337. permanently in his works, and  so consequently improves and
  338. develops it.
  339.  
  340. Please, see more info at URL: http://www.glasnet.ru/~mtrofimov/
  341.  
  342. _____________________________________________________
  343.  
  344. THANK YOU  for your interest to MT2 software,
  345.  
  346. Michael Trofimov. 
  347. ______________________________________________________
  348.  
  349.